PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Control Manager >

Programming With the Mac OS 8.5 Control Manager

SetControlProperty

Associates data with a control.

pascal OSStatus SetControlProperty (
                     ControlHandle control,
                     OSType propertyCreator,
                     OSType propertyTag,
                     UInt32 propertySize,
                     void *propertyData);
control
A value of type ControlHandle . Pass a handle to the control with which you wish to associate data.
propertyCreator
A four-character code. Pass your program's signature, as registered through Apple Developer Technical Support. If your program is of a type that would not normally have a signature (for example, a plug-in), you should still register and use a signature in this case, even though your program's file may not have the same creator code as the signature that you register. The 'macs' property signature is reserved for the system and should not be used.
propertyTag
A four-character code. Pass a value identifying the data. You define the tag your application uses to identify the data.
propertySize
An unsigned 32-bit integer. Pass a value specifying the size of the data.
propertyData
A pointer to data of any type. Pass a pointer to a buffer containing the data to be associated; this buffer should be at least as large as the value specified in the propertySize parameter.
function result
A result code. See Result Codes for the Mac OS 8.5 Control Manager .

DISCUSSION

Your application may use the SetControlProperty function to associate any type of data with a control.


VERSION NOTES

Available with Mac OS 8.5 and later.


SEE ALSO

The function GetControlProperty .

The function RemoveControlProperty .

© 1999 Apple Computer, Inc. — (Last Updated 20 Jan 99)